HAL SD APIs listing for migration

This section provides a full listing of the HAL1 SD APIs for STM32 HAL1 to HAL2 migration.

HAL SD constants

HAL1

series

HAL2

Refer to

BLOCKSIZE

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

CARD_HIGH_SPEED

u5, h5, l4, h7

Removed / New Usage changes

Refer to

CARD_NORMAL_SPEED

u5, h5, l4, h7

Removed / New Usage changes

Refer to

CARD_SDHC_SDXC

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

CARD_SDSC

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

CARD_SECURED

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

CARD_ULTRA_HIGH_SPEED

u5, h5, l4, h7

Removed / New Usage changes

Refer to

CARD_V1_X

u5, h5, l4, f4, h7

hal_sd_specification_version_t

Refer to

CARD_V2_X

u5, h5, l4, f4, h7

hal_sd_specification_version_t

Refer to

HAL_SDEx_DMALinkedList_ReadCpltCallback

u5, h5

Removed / New Usage changes

Refer to

HAL_SDEx_DMALinkedList_WriteCpltCallback

u5, h5

Removed / New Usage changes

Refer to

HAL_SD_CARD_DISCONNECTED

u5, h5, l4, f4, h7

HAL_SD_CARD_DISCONNECTED

Refer to

HAL_SD_CARD_ERROR

u5, h5, l4, f4, h7

HAL_SD_CARD_ERROR

Refer to

HAL_SD_CARD_IDENTIFICATION

u5, h5, l4, f4, h7

HAL_SD_CARD_IDENTIFICATION

Refer to

HAL_SD_CARD_PROGRAMMING

u5, h5, l4, f4, h7

HAL_SD_CARD_PROGRAMMING

Refer to

HAL_SD_CARD_READY

u5, h5, l4, f4, h7

HAL_SD_CARD_READY

Refer to

HAL_SD_CARD_RECEIVING

u5, h5, l4, f4, h7

HAL_SD_CARD_RECEIVING

Refer to

HAL_SD_CARD_SENDING

u5, h5, l4, f4, h7

HAL_SD_CARD_SENDING

Refer to

HAL_SD_CARD_STANDBY

u5, h5, l4, f4, h7

HAL_SD_CARD_STANDBY

Refer to

HAL_SD_CARD_TRANSFER

u5, h5, l4, f4, h7

HAL_SD_CARD_TRANSFER

Refer to

HAL_SD_ERROR_ADDR_MISALIGNED

u5, h5, l4, f4, h7

HAL_SD_ERROR_ADDR_MISALIGNED

Refer to

HAL_SD_ERROR_ADDR_OUT_OF_RANGE

u5, h5, l4, f4, h7

HAL_SD_ERROR_ADDR_OUT_OF_RANGE

Refer to

HAL_SD_ERROR_AKE_SEQ_ERR

u5, h5, l4, f4, h7

HAL_SD_ERROR_AKE_SEQ_ERR

Refer to

HAL_SD_ERROR_BAD_ERASE_PARAM

u5, h5, l4, f4, h7

HAL_SD_ERROR_BAD_ERASE_PARAM

Refer to

HAL_SD_ERROR_BLOCK_LEN_ERR

u5, h5, l4, f4, h7

HAL_SD_ERROR_BLOCK_LEN_ERR

Refer to

HAL_SD_ERROR_BUSY

u5, h5, l4, f4, h7

HAL_SD_ERROR_BUSY

Refer to

HAL_SD_ERROR_CARD_ECC_DISABLED

u5, h5, l4, f4, h7

HAL_SD_ERROR_CARD_ECC_DISABLED

Refer to

HAL_SD_ERROR_CARD_ECC_FAILED

u5, h5, l4, f4, h7

HAL_SD_ERROR_CARD_ECC_FAILED

Refer to

HAL_SD_ERROR_CC_ERR

u5, h5, l4, f4, h7

HAL_SD_ERROR_CC_ERR

Refer to

HAL_SD_ERROR_CID_CSD_OVERWRITE

u5, h5, l4, f4, h7

HAL_SD_ERROR_CID_CSD_OVERWRITE

Refer to

HAL_SD_ERROR_CMD_CRC_FAIL

u5, h5, l4, f4, h7

HAL_SD_ERROR_CMD_CRC_FAIL

Refer to

HAL_SD_ERROR_CMD_RSP_TIMEOUT

u5, h5, l4, f4, h7

HAL_SD_ERROR_CMD_RSP_TIMEOUT

Refer to

HAL_SD_ERROR_COM_CRC_FAILED

u5, h5, l4, f4, h7

HAL_SD_ERROR_COM_CRC_FAILED

Refer to

HAL_SD_ERROR_DATA_CRC_FAIL

u5, h5, l4, f4, h7

HAL_SD_ERROR_DATA_CRC_FAIL

Refer to

HAL_SD_ERROR_DATA_TIMEOUT

u5, h5, l4, f4, h7

HAL_SD_ERROR_DATA_TIMEOUT

Refer to

HAL_SD_ERROR_DMA

u5, h5, l4, f4, h7

HAL_SD_ERROR_DMA

Refer to

HAL_SD_ERROR_ERASE_RESET

u5, h5, l4, f4, h7

HAL_SD_ERROR_ERASE_RESET

Refer to

HAL_SD_ERROR_ERASE_SEQ_ERR

u5, h5, l4, f4, h7

HAL_SD_ERROR_ERASE_SEQ_ERR

Refer to

HAL_SD_ERROR_GENERAL_UNKNOWN_ERR

u5, h5, l4, f4, h7

HAL_SD_ERROR_GENERAL_UNKNOWN_ERR

Refer to

HAL_SD_ERROR_ILLEGAL_CMD

u5, h5, l4, f4, h7

HAL_SD_ERROR_ILLEGAL_CMD

Refer to

HAL_SD_ERROR_INVALID_CALLBACK

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_ERROR_INVALID_VOLTRANGE

u5, h5, l4, f4, h7

HAL_SD_ERROR_INVALID_VOLTRANGE

Refer to

HAL_SD_ERROR_LOCK_UNLOCK_FAILED

u5, h5, l4, f4, h7

HAL_SD_ERROR_LOCK_UNLOCK_FAILED

Refer to

HAL_SD_ERROR_NONE

u5, h5, l4, f4, h7

HAL_SD_ERROR_NONE

Refer to

HAL_SD_ERROR_PARAM

u5, h5, l4, f4, h7

HAL_SD_ERROR_INVALID_PARAM

Refer to

HAL_SD_ERROR_REQUEST_NOT_APPLICABLE

u5, h5, l4, f4, h7

HAL_SD_ERROR_REQUEST_NOT_APPLICABLE

Refer to

HAL_SD_ERROR_RX_OVERRUN

u5, h5, l4, f4, h7

HAL_SD_ERROR_RX_OVERRUN

Refer to

HAL_SD_ERROR_STREAM_READ_UNDERRUN

u5, h5, l4, f4, h7

HAL_SD_ERROR_STREAM_READ_UNDERRUN

Refer to

HAL_SD_ERROR_STREAM_WRITE_OVERRUN

u5, h5, l4, f4, h7

HAL_SD_ERROR_STREAM_WRITE_OVERRUN

Refer to

HAL_SD_ERROR_TIMEOUT

u5, h5, l4, f4, h7

HAL_SD_ERROR_TIMEOUT

Refer to

HAL_SD_ERROR_TX_UNDERRUN

u5, h5, l4, f4, h7

HAL_SD_ERROR_TX_UNDERRUN

Refer to

HAL_SD_ERROR_UNSUPPORTED_FEATURE

u5, h5, l4, f4, h7

HAL_SD_ERROR_UNSUPPORTED_FEATURE

Refer to

HAL_SD_ERROR_WP_ERASE_SKIP

u5, h5, l4, f4, h7

HAL_SD_ERROR_WP_ERASE_SKIP

Refer to

HAL_SD_ERROR_WRITE_PROT_VIOLATION

u5, h5, l4, f4, h7

HAL_SD_ERROR_WRITE_PROT_VIOLATION

Refer to

SD_CONTEXT_DMA

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

SD_CONTEXT_IT

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

SD_CONTEXT_NONE

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

SD_CONTEXT_READ_MULTIPLE_BLOCK

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

SD_CONTEXT_READ_SINGLE_BLOCK

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

SD_CONTEXT_WRITE_MULTIPLE_BLOCK

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

SD_CONTEXT_WRITE_SINGLE_BLOCK

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL SD enumerations

HAL1

series

HAL2

Refer to

HAL_SDEx_DMABuffer_MemoryTypeDef

l4, h7

Not implemented yet in HAL2.

Refer to

HAL_SD_ABORT_CB_ID

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_CallbackIDTypeDef

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_ERROR_CB_ID

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_MSP_DEINIT_CB_ID

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_MSP_INIT_CB_ID

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_READ_DMA_DBL_BUF0_CPLT_CB_ID

l4, h7

Removed / New Usage changes

Refer to

HAL_SD_READ_DMA_DBL_BUF1_CPLT_CB_ID

l4, h7

Removed / New Usage changes

Refer to

HAL_SD_READ_DMA_LNKLST_BUF_CPLT_CB_ID

u5, h5

Removed / New Usage changes

Refer to

HAL_SD_RX_CPLT_CB_ID

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_STATE_BUSY

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_STATE_ERROR

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_STATE_PROGRAMMING

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_STATE_READY

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_STATE_RECEIVING

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_STATE_RESET

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_STATE_TIMEOUT

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_STATE_TRANSFER

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_StateTypeDef

u5, h5, l4, f4, h7

hal_sd_state_t

Refer to

HAL_SD_TX_CPLT_CB_ID

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_WRITE_DMA_DBL_BUF0_CPLT_CB_ID

l4, h7

Removed / New Usage changes

Refer to

HAL_SD_WRITE_DMA_DBL_BUF1_CPLT_CB_ID

l4, h7

Removed / New Usage changes

Refer to

HAL_SD_WRITE_DMA_LNKLST_BUF_CPLT_CB_ID

u5, h5

Removed / New Usage changes

Refer to

SD_DMA_BUFFER0

l4, h7

Not implemented yet in HAL2.

Refer to

SD_DMA_BUFFER1

l4, h7

Not implemented yet in HAL2.

Refer to

HAL SD macros

HAL1

series

HAL2

Refer to

__HAL_SD_CLEAR_FLAG

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

__HAL_SD_CLEAR_IT

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

__HAL_SD_DISABLE

l4, f4

Not implemented yet in HAL2.

Refer to

__HAL_SD_DISABLE_IT

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

__HAL_SD_DMA_DISABLE

l4, f4

Not implemented yet in HAL2.

Refer to

__HAL_SD_DMA_ENABLE

l4, f4

Not implemented yet in HAL2.

Refer to

__HAL_SD_ENABLE

l4, f4

Not implemented yet in HAL2.

Refer to

__HAL_SD_ENABLE_IT

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

__HAL_SD_GET_FLAG

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

__HAL_SD_GET_IT

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

__HAL_SD_RESET_HANDLE_STATE

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL SD structures

HAL1

series

HAL2

Refer to

HAL_SD_CardCIDTypeDef

u5, h5, l4, f4, h7

hal_sd_card_cid_t

Refer to

HAL_SD_CardCSDTypeDef

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_CardInfoTypeDef

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_CardStatusTypeDef

u5, h5, l4, f4, h7

hal_sd_card_status_t

Refer to

SD_DMALinkNodeConfTypeDef

u5, h5

Removed / New Usage changes

Refer to

SD_DMALinkNodeTypeDef

u5, h5

hal_sd_node_t

Refer to

SD_DMALinkedListTypeDef

u5, h5

Removed / New Usage changes

Refer to

SD_HandleTypeDef

u5, h5, l4, f4, h7

hal_sd_handle_t

Refer to

SD_InitTypeDef

u5, h5, l4, f4, h7

hal_sd_config_t

Refer to

SD_TypeDef

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL SD functions

HAL1

series

HAL2

Refer to

HAL_SDEx_ChangeDMABuffer

l4, h7

Not implemented yet in HAL2.

Refer to

HAL_SDEx_ConfigDMAMultiBuffer

l4, h7

Not implemented yet in HAL2.

Refer to

HAL_SDEx_DMALinkedList_BuildNode

u5, h5

HAL_SD_FillNodeConfig

Refer to

HAL_SDEx_DMALinkedList_DisableCircularMode

u5, h5

Removed / New Usage changes

Refer to

HAL_SDEx_DMALinkedList_EnableCircularMode

u5, h5

Removed / New Usage changes

Refer to

HAL_SDEx_DMALinkedList_InsertNode

u5, h5

Removed / New Usage changes

Refer to

HAL_SDEx_DMALinkedList_LockNode

u5, h5

Removed / New Usage changes

Refer to

HAL_SDEx_DMALinkedList_ReadBlocks

u5, h5

HAL_SD_ReadBlocks_LinkedList

Refer to

HAL_SDEx_DMALinkedList_RemoveNode

u5, h5

Removed / New Usage changes

Refer to

HAL_SDEx_DMALinkedList_UnlockNode

u5, h5

Removed / New Usage changes

Refer to

HAL_SDEx_DMALinkedList_WriteBlocks

u5, h5

HAL_SD_WriteBlocks_LinkedList

Refer to

HAL_SDEx_DriveTransceiver_1_8V_Callback

l4

HAL_SD_RegisterTransceiverCallback

Refer to

HAL_SDEx_HighSpeed

l4

Not implemented yet in HAL2.

Refer to

HAL_SDEx_ReadBlocksDMAMultiBuffer

l4, h7

Not implemented yet in HAL2.

Refer to

HAL_SDEx_Read_DMADoubleBuf0CpltCallback

h7

Not implemented yet in HAL2.

Refer to

HAL_SDEx_Read_DMADoubleBuf1CpltCallback

h7

Not implemented yet in HAL2.

Refer to

HAL_SDEx_Read_DMADoubleBuffer0CpltCallback

l4

Not implemented yet in HAL2.

Refer to

HAL_SDEx_Read_DMADoubleBuffer0CpltCallback

h7

Not implemented yet in HAL2.

Refer to

HAL_SDEx_Read_DMADoubleBuffer1CpltCallback

l4

Not implemented yet in HAL2.

Refer to

HAL_SDEx_Read_DMADoubleBuffer1CpltCallback

h7

Not implemented yet in HAL2.

Refer to

HAL_SDEx_Read_DMALnkLstBufCpltCallback

u5, h5

Removed / New Usage changes

Refer to

HAL_SDEx_WriteBlocksDMAMultiBuffer

l4, h7

Not implemented yet in HAL2.

Refer to

HAL_SDEx_Write_DMADoubleBuf0CpltCallback

h7

Not implemented yet in HAL2.

Refer to

HAL_SDEx_Write_DMADoubleBuf1CpltCallback

h7

Not implemented yet in HAL2.

Refer to

HAL_SDEx_Write_DMADoubleBuffer0CpltCallback

l4

Not implemented yet in HAL2.

Refer to

HAL_SDEx_Write_DMADoubleBuffer0CpltCallback

h7

Not implemented yet in HAL2.

Refer to

HAL_SDEx_Write_DMADoubleBuffer1CpltCallback

l4

Not implemented yet in HAL2.

Refer to

HAL_SDEx_Write_DMADoubleBuffer1CpltCallback

h7

Not implemented yet in HAL2.

Refer to

HAL_SDEx_Write_DMALnkLstBufCpltCallback

u5, h5

Removed / New Usage changes

Refer to

HAL_SD_Abort

u5, h5, l4, f4, h7

HAL_SD_Abort

Refer to

HAL_SD_AbortCallback

u5, h5, l4, f4, h7

HAL_SD_AbortCallback

Refer to

HAL_SD_Abort_IT

u5, h5, l4, f4, h7

HAL_SD_Abort_IT

Refer to

HAL_SD_ConfigSpeedBusOperation

u5, h5, l4, h7

HAL_SD_SwitchSpeedMode

Refer to

HAL_SD_ConfigWideBusOperation

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_DeInit

u5, h5, l4, f4, h7

HAL_SD_DeInit

Refer to

HAL_SD_DriveTransceiver_1_8V_Callback

u5, h5, h7

HAL_SD_RegisterTransceiverCallback

Refer to

HAL_SD_DriveTransciver_1_8V_Callback

h7

HAL_SD_RegisterTransceiverCallback

Refer to

HAL_SD_Erase

u5, h5, l4, f4, h7

HAL_SD_Erase

Refer to

HAL_SD_ErrorCallback

u5, h5, l4, f4, h7

HAL_SD_ErrorCallback

Refer to

HAL_SD_GetCardCID

u5, h5, l4, f4, h7

HAL_SD_GetCardCID

Refer to

HAL_SD_GetCardCSD

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_GetCardInfo

u5, h5, l4, f4, h7

HAL_SD_GetCardInfo

Refer to

HAL_SD_GetCardState

u5, h5, l4, f4, h7

HAL_SD_GetCardState

Refer to

HAL_SD_GetCardStatus

u5, h5, l4, f4, h7

HAL_SD_GetCardStatus

Refer to

HAL_SD_GetError

u5, h5, l4, f4, h7

HAL_SD_GetLastErrorCodes

Refer to

HAL_SD_GetState

u5, h5, l4, f4, h7

HAL_SD_GetState

Refer to

HAL_SD_IRQHandler

u5, h5, l4, f4, h7

HAL_SD_IRQHandler

Refer to

HAL_SD_Init

u5, h5, l4, f4, h7

HAL_SD_Init

Refer to

HAL_SD_InitCard

u5, h5, l4, f4, h7

HAL_SD_NotifyCardInsertion

Refer to

HAL_SD_MspDeInit

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_MspInit

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_ReadBlocks

u5, h5, l4, f4, h7

HAL_SD_ReadBlocks

Refer to

HAL_SD_ReadBlocks_DMA

u5, h5, l4, f4, h7

HAL_SD_ReadBlocks_DMA

Refer to

HAL_SD_ReadBlocks_IT

u5, h5, l4, f4, h7

HAL_SD_ReadBlocks_IT

Refer to

HAL_SD_RegisterCallback

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_RegisterTransceiverCallback

u5, h5, l4, h7

HAL_SD_RegisterTransceiverCallback

Refer to

HAL_SD_RxCpltCallback

u5, h5, l4, f4, h7

HAL_SD_XferCpltCallback

Refer to

HAL_SD_TxCpltCallback

u5, h5, l4, f4, h7

HAL_SD_XferCpltCallback

Refer to

HAL_SD_UnRegisterCallback

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

HAL_SD_UnRegisterTransceiverCallback

u5, h5, l4, h7

Removed / New Usage changes

Refer to

HAL_SD_WriteBlocks

u5, h5, l4, f4, h7

HAL_SD_WriteBlocks

Refer to

HAL_SD_WriteBlocks_DMA

u5, h5, l4, f4, h7

HAL_SD_WriteBlocks_DMA

Refer to

HAL_SD_WriteBlocks_IT

u5, h5, l4, f4, h7

HAL_SD_WriteBlocks_IT

Refer to

pSD_CallbackTypeDef

u5, h5, l4, f4, h7

Removed / New Usage changes

Refer to

pSD_TransceiverCallbackTypeDef

u5, h5, l4, h7

Removed / New Usage changes

Refer to

HAL SD legacy aliases (HAL1 to HAL1)

HAL1 legacy API alias

HAL1 API

HAL_SDEx_Read_DMADoubleBuffer0CpltCallback

HAL_SDEx_Read_DMADoubleBuf0CpltCallback

HAL_SDEx_Read_DMADoubleBuffer1CpltCallback

HAL_SDEx_Read_DMADoubleBuf1CpltCallback

HAL_SDEx_Write_DMADoubleBuffer0CpltCallback

HAL_SDEx_Write_DMADoubleBuf0CpltCallback

HAL_SDEx_Write_DMADoubleBuffer1CpltCallback

HAL_SDEx_Write_DMADoubleBuf1CpltCallback

HAL_SD_DriveTransciver_1_8V_Callback

HAL_SD_DriveTransceiver_1_8V_Callback